home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / slassq.z / slassq
Text File  |  1996-03-14  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))                                                          SSSSLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SLASSQ - return the values scl and smsq such that   ( scl**2 )*smsq = x(
  10.      1 )**2 +...+ x( n )**2 + ( scale**2 )*sumsq,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE SLASSQ( N, X, INCX, SCALE, SUMSQ )
  14.  
  15.          INTEGER        INCX, N
  16.  
  17.          REAL           SCALE, SUMSQ
  18.  
  19.          REAL           X( * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      SLASSQ  returns the values  scl  and  smsq  such that
  23.  
  24.      where  x( i ) = X( 1 + ( i - 1 )*INCX ). The value of  sumsq  is assumed
  25.      to be non-negative and  scl  returns the value
  26.  
  27.         scl = max( scale, abs( x( i ) ) ).
  28.  
  29.      scale and sumsq must be supplied in SCALE and SUMSQ and
  30.      scl and smsq are overwritten on SCALE and SUMSQ respectively.
  31.  
  32.      The routine makes only one pass through the vector x.
  33.  
  34.  
  35. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  36.      N       (input) INTEGER
  37.              The number of elements to be used from the vector X.
  38.  
  39.      X       (input) REAL
  40.              The vector for which a scaled sum of squares is computed.  x( i )
  41.              = X( 1 + ( i - 1 )*INCX ), 1 <= i <= n.
  42.  
  43.      INCX    (input) INTEGER
  44.              The increment between successive values of the vector X.  INCX >
  45.              0.
  46.  
  47.      SCALE   (input/output) REAL
  48.              On entry, the value  scale  in the equation above.  On exit,
  49.              SCALE is overwritten with  scl , the scaling factor for the sum
  50.              of squares.
  51.  
  52.      SUMSQ   (input/output) REAL
  53.              On entry, the value  sumsq  in the equation above.  On exit,
  54.              SUMSQ is overwritten with  smsq , the basic sum of squares from
  55.              which  scl  has been factored out.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.